home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 23 / lazer12.zip / LAZER.DOC < prev    next >
Text File  |  1988-10-31  |  9KB  |  336 lines
  1. *************************************************************************
  2.  
  3.       LAZER - Macro Typesetter for HP LaserJet++ and Compatibles
  4.  
  5.                              Version 1.2
  6.  
  7.                      (c) 1987 Jim Bumgardner
  8.  
  9. *************************************************************************
  10. Revision History:
  11.  
  12. Version 1.2         05/88-10/88
  13.  
  14.     Added IP (Include PCX graphic file)
  15.     Added IR (Include RAW printer commands)
  16.     Added proper TAB handling
  17.     Included Source Code in Archive
  18.     Included OKIPIE program in Archive
  19.  
  20. Version 1.1        12/87
  21.  
  22.     Fixed the bugs in 1.0
  23. *************************************************************************
  24. The most recent version of this program can be found at
  25.  
  26.         Cooper Works BBS     1-608-271-3685
  27.  
  28.  
  29. *************************************************************************
  30. You are hereby granted permission to use this program for
  31. non-commericial pursuits, and to upload this archive to
  32. bulletin boards.  The author doesn't expect any donations or
  33. tech support questions.
  34.  
  35.     James Bumgardner
  36.     711 E. Cypress, Apt A.
  37.     Burbank, CA  91501
  38.     (818)846-7781 (PLINK BUM)
  39.  
  40. *******************************************************************
  41. This Archive Contains:
  42.  
  43.     LAZER.C            Source Code
  44.     LAZER.EXE        The Typesetting program.
  45.     LAZER.DOC        What It Is
  46.     OKI.TXT            Sample Header file for OKI LaserLine
  47.     FORM.TXT        Sample Form
  48.     OKIPIE11.ARC        OKIPIE Pie Graphing Program
  49.  
  50. *************************************************************************
  51. This program processes ascii text files which contain special commands
  52. in Brackets [].  For example, you could use it to quickly insert some
  53. boldface or italics into a text file.  For example.
  54.  
  55. This is a regular sentance with some [!]boldface[!] and [/]italics[/].
  56.  
  57. Many, but not all, HP+ commands are supported.  Some commands directly
  58. translate into a corresponding HP command.  Other commands are more
  59. sophisticated, and actually do some useful things the printer can't
  60. do.  LAZER can perform these functions:
  61.  
  62.     - Download soft fonts
  63.  
  64.     - Read text from an "include" file (Nesting up to 16 levels).
  65.  
  66.       ** The file OKI.TXT is a special include file to assign font-ids
  67.       to the resident fonts on an OKI Laserline.  You may want to use
  68.       this as a model for setting up your printer.
  69.  
  70.     - Print graphics from a .PCX file or a straight bitmap.
  71.  
  72.     - Make Lazer Output Files more understandable by allowing you to
  73.       insert comments.
  74.  
  75.     - Make HPLJ macros easier to generate.
  76.  
  77. Many other programs I write generate their output in LAZER format, so
  78. I can easily read their output and make small modifications.  Since the
  79. source-code is provided, you could potentially write a subset of LAZER
  80. for other printers.
  81.  
  82. The OKIPIE program included in this archive generates hi-res pie graphs
  83. in .PCX format.  It typesets the piegraph using LAZER.
  84.  
  85.  
  86. *************************************************************************
  87. Sample Usage
  88. ------------
  89.     LAZER form.txt        (This outputs to LPT1)
  90.  
  91.     LAZER form.txt LPT2
  92.         or
  93.     LAZER form.txt 2    (This outputs to LPT2)
  94.  
  95.     LAZER form.txt outfile    (This outputs to a file)
  96.  
  97.  
  98.  
  99. Options
  100. -------
  101.     -C#            Number of Copies (Works with explicit
  102.                 formfeeds only).
  103.  
  104.     -N            Don't download fonts.
  105.  
  106. Example:
  107.     LAZER -C2 form.txt    Print two copies of form.txt
  108.  
  109. *************************************************************************
  110. Command Glossary
  111. ----------------
  112. Lazer files combine text and typesetting commands.
  113.  
  114. All Typesetting Commands are surrounded with []
  115. To actually print a left square bracket, use [[.
  116. To print this document using LAZER, replace all single left brackets with [[.
  117.  
  118. You can chain multiple commands in the same set of brackets, and put
  119. white space (spaces,tabs,returns) between commands.  Like so:
  120.  
  121. [            ; this is a comment
  122.     L1200,2300    ; Locate Cursor
  123.     F0        ; Font Zero
  124. ]
  125.  
  126. All filenames are surrounded with <>
  127.  
  128. [
  129.     L1200,1200        ; Locate Cursor
  130.     IP150<piechart.map>    ; Print .PCX graphic at 150 resolution
  131. ]
  132.  
  133. Basic Commands
  134. --------------
  135. LAZER IS case-senstive for the first letter of most commands.
  136.  
  137. [E]    Escape
  138.     This sends an escape to your printer, allowing you to use
  139.     escape codes LAZER doesn't support.
  140.  
  141. [^x]    Control Characters
  142.     Same Idea.
  143.  
  144. [F#]    Select Font
  145. [F#<file>] Download Font
  146.     
  147.     Examples:
  148.          [F0]            (select font # 0)
  149.          [F2<OPT10.SFP>]    (download opt10.sfp as font # 2).
  150.  
  151.     Font Filenames default to .SFP
  152.  
  153. [A#]    Assign Font-ID
  154.     Assigns a Font-ID to the last descibed Font - useful for assigning
  155.     IDs to resident and cartridge fonts.  After assigning a font id,
  156.     you may use the [F#] command to select that font.
  157.  
  158. [H#]    Select Pitch        Specify characters per inch.
  159.  
  160. [V#]    Select Point Size    Specify points (1/72")
  161.  
  162. [(xx]    Select Symbol Set     (e.g. [(OU] )
  163.         
  164. [T#]    Type Face        (0-10)
  165.  
  166. [P#]    Spacing: 0 - fixed, 1 - proportional, -1 Compressed Prop
  167.  
  168. [O#]    Orientation: Landscape [O1]    Portrait [O0]
  169.  
  170.     You not combine landscape and portrait on the same page.
  171.     These commands remain in effect until turned off - be sure to
  172.     reset at the next page, if desired.
  173.  
  174. [D#]    Lines Per Inch        Specify lines per inch
  175.  
  176.  
  177. [!]    Bold Toggle        Example: He was a [!]bad[!] boy.
  178. [/]    Italic Toggle
  179. [_]    Underline Toggle
  180.  
  181. [M?#]    Set Margin
  182.  
  183.     l    left margin in columns
  184.     r    right margin in columns
  185.     t    top margin in lines
  186.  
  187.     Examples:
  188.         [Ml10        ; Set left margin to 10th column]
  189.  
  190.  
  191. [Mc]    Clear Margins
  192.  
  193.  
  194. [f]    FormFeed
  195.  
  196.  
  197. Graphics
  198. --------
  199. [L#,#]    Locate X,Y
  200. [L,#]    Locate Y
  201. [L#]    Locate X
  202.     Locate cursor at XX-YY coordinates (1/720" increments)
  203.     X and Y values may be offsets (use + and - signs).
  204.  
  205.     Examples:
  206.         [L0,0]            (Locate at home position)
  207.         [L+720]            (Locate an inch to the right)
  208.  
  209. [LS]    Push Cursor
  210. [LR]    Pop Cursor
  211.     You may save and restore the cursor position mutliple times on
  212.     a Last in First out basis.
  213.  
  214. [G#]    Set Grey Scale    
  215.     This command sets a grey scale for drawing lines and boxes.
  216.     The grey scale value is independent from the pattern value.
  217.     Specify 1-100.
  218.  
  219. [p#]    Set Pattern
  220.     This command sets up a pattern for drawing lines and boxes. See
  221.     your printer manual for examples.
  222.  
  223.     1    Horizontal Lines
  224.     2     Vertical Lines
  225.     3    Diagonal to upper right.
  226.     4    Diagonal to lower right
  227.     5    1+2    Criss Cross
  228.     6    3+4    Criss Cross
  229.  
  230. [R?##,##] Print Rule (Lines and Boxes)
  231.     s or b    Solid
  232.     g    Grey Scale
  233.     p    Pattern
  234.     ##,##    Height and Width in 1/720" increments
  235.  
  236.     Examples:
  237.         [
  238.             ; Draw a little shaded box
  239.             LS 
  240.             L,-150 Rb385,2 Rb2,150 Rg385,150
  241.             L,+150 Rb385,2 
  242.             L+385,-150 Rb2,150 
  243.             LR
  244.         ]
  245.  
  246. Control and Macros
  247. ------------------
  248.  
  249. [N+]    Ignore Returns
  250.     Causes CR-LFs outside of brackets to be ignored.  This is useful
  251.     for making complex forms more readable.
  252.  
  253. [N-]    Don't Ignore Returns
  254.  
  255.  
  256. [I<file>]   Include File
  257.  
  258.     Starts reading commands from the specified file.  Good for standard
  259.     letter heads, etc.  Often, include files will contain a series
  260.     of macros (see below).  After the file is read, control is transfered
  261.     back to the original file.  You may nest up to 16 levels.
  262.  
  263.     Include filenames default to .TXT
  264.  
  265. [IR<file>]   Include Raw File (RAW)
  266.  
  267.     This downloads the contents of a file to the printer without any
  268.     special processing.  Extension defaults to ".PRN".
  269.  
  270. [*{#]    Start Macro
  271. [*}]    End Macro
  272. [*#]    Execute Macro
  273.  
  274.     
  275.     The first two commands define a "Macro", a set of commands which are
  276.     identified by number, and then can be executed over and over again.
  277.     Between these two commands, place all the instructions or text you want
  278.     the macro to perform.  Macros are stored by the printer, and will
  279.     execute    faster then sending the same text over again.
  280.  
  281.     Example:
  282.      [    ; 3 macros used for drawing dip-switch boxes
  283.         ; Down switch
  284.         *{1 LS L+12,-100 RB2,100 L-12,+74 RB25,25 LR L+45 *}
  285.         ; Up switch
  286.         *{2 LS L,-100 RB26,26 L+12 RB2,100 LR L+45 *}
  287.         ; Surrounding Box
  288.         *{3 LS L,+25 L,-150 RB385,2 RB2,150
  289.             L,+150 RB385,2 L+385,-150 RB2,150 LR L+20 *}
  290.     ]
  291.        [_]Okidata 182 Settings[_]
  292.  
  293.     SW1     [*3*1*2*2*2*1*2*1*1]
  294.             [H16]12345678[H10]
  295.  
  296.  
  297.     SW2     [*3*1*1*1*1*2*1*2*1]
  298.             [H16]12345678[H10]
  299.  
  300.  
  301. Raster Graphics
  302. ---------------
  303. [IB<file>]    Print Bitmap at default resolution
  304. [IB#<file>]    Print Bitmap at particular resolution (75,150,300)
  305. [IBI<file>]    Print Bitmap Inverted
  306. [IP<file>]    Print PCX File
  307. [IPI<file>]    Print PCX Inverted (white <-> black)
  308. [IPI#<file>]    Print PCX Inverted at particular resolution (75,150,300)
  309.  
  310.     A bitmap is a file with a picture in it.  The first 4 bytes contain
  311.     the bitmap's dimensions (Horizontal , Vertical).  The rest of the
  312.     file is the bitmap.  The bitmap is read in at the current cursor
  313.     position.
  314.  
  315.     PCX files are generated by PC Paintbrush, and some other programs.
  316.     LAZER has only been tested with monochrome PCX files.
  317.  
  318.     You may optionally specify a resolution (300, 150 or 75 dpi).
  319.     300, or the last reso used, is the default.
  320.  
  321.     You may optionally specify I to invert the bitmap colors.
  322.  
  323.     Bitmap Filenames default to .MAP
  324.     PCX filenames default to .PCX
  325.  
  326.     Examples:
  327.  
  328.         [
  329.             L750,750 IPI150<picture>
  330.             L4000,4000 IB<bitmap>
  331.         ]
  332.  
  333.  
  334.  
  335. ** END OF DOCUMENTATION **
  336.